Additions

svn path=/trunk/; revision=22013

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 4257b7ef0793ccb39d40a61481870b09eb596b4e..764e545eb9c17b39aa01c0d67e3658ae92911d60 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2008-12-30  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/tmpl/gtkorientable.sgml:
+       * gtk/tmpl/gtkvscrollbar.sgml:
+       * gtk/tmpl/gtkhsv.sgml: Add short/long description.
+
 2008-12-30  Matthias Clasen <mclasen@redhat.com>
 
        * gtk/tmpl/gtkwidget.sgml:

diff --git a/docs/reference/gtk/tmpl/gtkhsv.sgml b/docs/reference/gtk/tmpl/gtkhsv.sgml
new file mode 100644 (file)
index 0000000..1c2c2f4
--- /dev/null
+++ b/docs/reference/gtk/tmpl/gtkhsv.sgml
@@ -0,0 +1,124 @@
+<!-- ##### SECTION Title ##### -->
+GtkHSV
+
+<!-- ##### SECTION Short_Description ##### -->
+A 'color wheel' widget
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+#GtkHSV is the 'color wheel' part of a complete color selector widget.
+It allows to select a color by determining its HSV components in an
+intuitive way. Moving the selection around the outer ring changes the hue,
+and moving the selection point inside the inner triangle changes value and
+saturation.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+<variablelist>
+  <varlistentry>
+    <term>#GtkColorSelection</term>
+    <listitem>a complete color selection widget</listitem>
+  </varlistentry>
+  <varlistentry>
+    <term>#GtkColorSelectionDialog</term>
+    <listitem>a color selection dialog</listitem>
+  </varlistentry>
+</variablelist>
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkHSV ##### -->
+<para>
+
+</para>
+
+@parent_instance: 
+
+<!-- ##### FUNCTION gtk_hsv_new ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_hsv_set_color ##### -->
+<para>
+
+</para>
+
+@hsv: 
+@h: 
+@s: 
+@v: 
+
+
+<!-- ##### FUNCTION gtk_hsv_get_color ##### -->
+<para>
+
+</para>
+
+@hsv: 
+@h: 
+@s: 
+@v: 
+
+
+<!-- ##### FUNCTION gtk_hsv_set_metrics ##### -->
+<para>
+
+</para>
+
+@hsv: 
+@size: 
+@ring_width: 
+
+
+<!-- ##### FUNCTION gtk_hsv_get_metrics ##### -->
+<para>
+
+</para>
+
+@hsv: 
+@size: 
+@ring_width: 
+
+
+<!-- ##### FUNCTION gtk_hsv_is_adjusting ##### -->
+<para>
+
+</para>
+
+@hsv: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_hsv_to_rgb ##### -->
+<para>
+
+</para>
+
+@h: 
+@s: 
+@v: 
+@r: 
+@g: 
+@b: 
+
+
+<!-- ##### FUNCTION gtk_rgb_to_hsv ##### -->
+<para>
+
+</para>
+
+@r: 
+@g: 
+@b: 
+@h: 
+@s: 
+@v: 
+
+

diff --git a/docs/reference/gtk/tmpl/gtkorientable.sgml b/docs/reference/gtk/tmpl/gtkorientable.sgml
new file mode 100644 (file)
index 0000000..72ff0d5
--- /dev/null
+++ b/docs/reference/gtk/tmpl/gtkorientable.sgml
@@ -0,0 +1,56 @@
+<!-- ##### SECTION Title ##### -->
+Orientable
+
+<!-- ##### SECTION Short_Description ##### -->
+An interface for flippable widgets
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The #GtkOrientable interface is implemented by all widgets that can be 
+oriented horizontally or vertically. Historically, such widgets have been 
+realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox
+and #GtkScale/#GtkHScale/#GtkVScale). GtkOrientable is more flexible in that 
+it allows the orientation to be changed at runtime, allowing the widgets
+to 'flip'.
+</para>
+<para>
+GtkOrientable was introduced in GTK+ 2.16.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkOrientable ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkOrientable:orientation ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION gtk_orientable_get_orientation ##### -->
+<para>
+
+</para>
+
+@orientable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_orientable_set_orientation ##### -->
+<para>
+
+</para>
+
+@orientable: 
+@orientation: 
+
+

diff --git a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml b/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
index 3365ab233faccb9ad66b817b3d33ad090affc8df..44ce1ec49d7d5078b4c5a93cd3837fde8b78f168 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
@@ -4,25 +4,27 @@ GtkVScrollbar
 <!-- ##### SECTION Short_Description ##### -->
 A vertical scrollbar
 
-
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+The #GtkVScrollbar widget is a widget arranged verticall creating a
+scrollbar. See #GtkScrollbar for details on
+scrollbars. #GtkAdjustment pointers may be added to handle the
+adjustment of the scrollbar or it may be left %NULL in which case one
+will be created for you. See #GtkAdjustment for details.
 </para>
 
-
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkScrollbar, #GtkScrolledWindow
 </para>
 
-
 <!-- ##### SECTION Stability_Level ##### -->
 
 
 <!-- ##### STRUCT GtkVScrollbar ##### -->
 <para>
-
+The #GtkVScrollbar struct contains private data and should be accessed
+using the functions below.
 </para>